home *** CD-ROM | disk | FTP | other *** search
/ The World of Computer Software / The World of Computer Software.iso / mt331.zip / MT.DOC < prev    next >
Text File  |  1993-01-01  |  46KB  |  1,074 lines

  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.                                  MsgTrack 3.31
  23.  
  24.                                 January 1, 1993
  25.  
  26.  
  27.                                   USER MANUAL
  28.  
  29.      
  30.                    Copyright (c) 1989-1993 Andrew D. Farmer.
  31.                               All rights reserved.
  32.  
  33.  
  34.  
  35.                                License Statement
  36.  
  37.  
  38.           The MsgTrack package is protected by both Canadian copyright 
  39.           law and international treaty provisions.
  40.  
  41.           MsgTrack is provided as is, without warranty of any kind, 
  42.           either expressed or implied.  Andrew D. Farmer only 
  43.           guarantees that MsgTrack will occupy disk space.
  44.  
  45.           In no event shall Andrew D. Farmer be liable to you or 
  46.           anyone else for any damages, including any lost profits, 
  47.           lost savings or other incidental or consequential damages 
  48.           arising out of the use or inability to use this program.
  49.  
  50.           All Andrew D. Farmer products are trademarks or registered 
  51.           trademarks of Andrew D. Farmer.
  52.  
  53.  
  54.           ------------------------------------------------------------
  55.  
  56.           The noncommercial version of MsgTrack does not offer as many
  57.           'toys' as the commercial version, but it is =not= crippled,
  58.           nor does it quit working after a period of time.  It is
  59.           fully functional as provided.
  60.  
  61.           The noncommercial version is yours to keep. It is not public  
  62.           domain, shareware or freeware, it is simply free of charge. 
  63.  
  64.           You can use it as long as you do not use it within a
  65.           commercial environment.  It doesn't matter if you are
  66.           making money by using it or not, if you are using it within
  67.           commercial walls, you must purchase the commercial version.
  68.  
  69.           If you wish to purchase the commercial version, see the file
  70.           MT_ORDER.EUR (for europeans only) or MT_ORDER.ALL.  Both of
  71.           these files should have been located in the compressed file
  72.           MT_ORDER.ARJ, within the distribution archive.
  73.  
  74.           ------------------------------------------------------------
  75.  
  76.  
  77.                                    Chapter 1
  78.  
  79.                                     Preface
  80.  
  81.  
  82.      1.1  Archive
  83.  
  84.           The program archive, MT330.ARJ, should have included the
  85.           following files:
  86.  
  87.               MT.DOC       -  User manual.
  88.               MT.EXE       -  Main program.
  89.               MTLOG.EXE    -  Log analyzer.
  90.               MTSETUP.EXE  -  Setup program.
  91.               MT330.NEW    -  Release notes.
  92.               MT_ORDER.ARJ -  Order forms for the commercial version.
  93.  
  94.      1.2  System requirements
  95.  
  96.           Although it is possible to run MsgTrack on a system with 
  97.           less than the following equipment, the following should be 
  98.           considered the realistic minimum with which you can get by:
  99.  
  100.               A 100% IBM BIOS compatible computer system with at
  101.               least 384K of available RAM.
  102.  
  103.               MS-DOS or PC-DOS version 3.20 or greater.
  104.  
  105.      1.3  AFI environment variable
  106.  
  107.           MsgTrack will expect to find its configuration data files in  
  108.           the DOS current directory or the directory pointed to by the 
  109.           AFI environment variable.
  110.  
  111.      1.4  AFIOPT environment variable
  112.  
  113.           By default MT uses 'smart' (int 21h, function 60h) path
  114.           resolution code.  Under some configurations, this actually
  115.           returns an unuseable pathspec.  Setting AFIOPT=LOTEK_RES
  116.           tells MT to use 'dumb' or 'lotek' path resolution code
  117.           (this consists of resolving ambiguous paths to absolute
  118.           paths, but not doing any internal remapping).
  119.  
  120.      1.5  TZ environment variable
  121.  
  122.           MsgTrack uses the TZ environment variable to calculate 
  123.           Universal Coordinated Time (UTC).
  124.  
  125.           Examples:  TZ=EST05EDT   TZ=AEST-10   TZ=GMT00   TZ=UTC0
  126.  
  127.      1.6  Key
  128.  
  129.           The commercial version requires a key file for operation.  
  130.  
  131.  
  132.                                    Chapter 2
  133.  
  134.                                      Setup
  135.  
  136.  
  137.           The setup program, MTSETUP.EXE, is the backbone of MsgTrack.  
  138.           This full screen, menu driven, module is what you use to 
  139.           create and edit MsgTrack's configuration data files.
  140.  
  141.  
  142.      2.1  Video mode / command line syntax
  143.  
  144.           MTSetup will attempt to automatically use the correct video 
  145.           mode for your system, unfortunately some BIOSs return bogus 
  146.           information.  For that reason two command line options are 
  147.           available to you: -M will force MTSetup to use Mono video 
  148.           and -C will force MTSetup to use Colour video.
  149.  
  150.           Note: MTSetup uses direct screen writes.  If it detects
  151.                 DESQview, it will use the DV shadow buffer.
  152.  
  153.  
  154.      2.2  Errorlevels
  155.  
  156.           There are only 2 possible ErrorLevels that MTSetup can exit       
  157.           with.  Errorlevel 1 indicates a fatal error and Errorlevel 0 
  158.           indicates successful completion.
  159.  
  160.                   
  161.      2.3  Menus
  162.  
  163.           There are 6 top level (pull down) menus.  The settings 
  164.           available on the first 5 will be explained in this section.  
  165.           The 6th top menu, Managers, is explained in section 2.4.
  166.  
  167.  
  168.      2.3.1  File
  169.  
  170.           Copyright               This displays program identification 
  171.                                   and copyright information.  It will 
  172.                                   stay on the screen for 3 seconds, or 
  173.                                   until a key is pressed.
  174.  
  175.           Password                If a password is specified, all 
  176.                                   subsequent attempts to access 
  177.                                   MTSetup will require that the 
  178.                                   correct password to be provided.
  179.  
  180.           DOS Shell               This spawns a command shell using 
  181.                                   ComSpec. When you type EXIT to 
  182.                                   return to MTSetup, it will change 
  183.                                   directories back to where you were 
  184.                                   when you loaded MTSetup.
  185.  
  186.           DOS Shell (cont'd)      MTSetup will automatically attempt
  187.                                   to swap itself out of memory, when
  188.                                   spawning.  It will first attempt to
  189.                                   swap to EMS, if that fails it will
  190.                                   try for a swap to disk and if that
  191.                                   also fails, it will spawn without
  192.                                   swaping.
  193.  
  194.                                   You can also Shell to DOS by typing 
  195.                                   ALT-Z at any keyboard input field.
  196.  
  197.           Exit/Save               This causes MTSetup to quit and exit 
  198.                                   back to DOS. If you have made 
  199.                                   changes to your configuration, then 
  200.                                   you will be asked whether you wish 
  201.                                   to save the changes.
  202.  
  203.                                   You can also Exit/Save by typing ESC 
  204.                                   at any top level keyboard input field.
  205.  
  206.      2.3.2  General
  207.  
  208.           Address
  209.               Network Address     These are your network addresses 
  210.                                   (upto 20).
  211.  
  212.               Private Network     This is your private network number, 
  213.                                   if any.
  214.  
  215.               Domain Matching     This is a table of upto 30 domain 
  216.                                   names that should be mapped to a 
  217.                                   specific zone number.
  218.  
  219.           Sysops                  These are your names (upto 5).
  220.  
  221.                                   You can also choose whether or not
  222.                                   any messages addressed to an alias
  223.                                   (names 2-5) should be renamed so
  224.                                   that they are to your primary name.
  225.  
  226.           Paths
  227.               NetMail             This is the path to your network 
  228.                                   mail area.
  229.  
  230.               BadMail             This is the path to your bad mail 
  231.                                   area.  This is where MsgTrack will 
  232.                                   place bad messages.
  233.  
  234.               Inbound             This is the path to your mailer's 
  235.                                   inbound files area.
  236.  
  237.               SentMsgs            This is the path that you wish 
  238.                                   MsgTrack to place Sent message into.  
  239.                                   If not specified, the BadMail path 
  240.                                   will be used.
  241.  
  242.           Paths
  243.               RcvdMsgs            This is the path that you wish 
  244.                                   MsgTrack to place Received message
  245.                                   into. If not specified, the BadMail
  246.                                   path will be used.
  247.  
  248.               Nodelist            This is the path to your nodelist 
  249.                                   directory.  This is where MsgTrack 
  250.                                   will place, and expect to find, its 
  251.                                   nodelist index file (NODELIST.MTX).
  252.  
  253.               Semaphore           This is where MT will look for and
  254.                                   place semaphore files, such as the
  255.                                   FrontDoor rescan files.
  256.  
  257.           Nodelists               This is where you enter the names of 
  258.                                   your raw nodelist files (upto 10).  
  259.                                   This must include the complete path 
  260.                                   to the files.
  261.  
  262.                                   If you do not specify a file type 
  263.                                   (extension) MsgTrack will use the 
  264.                                   most recent file matching the trunk 
  265.                                   name.
  266.  
  267.                                   You can also choose whether or not 
  268.                                   nodes marked 'DOWN' should be 
  269.                                   included in the compiled index.
  270.  
  271.           Log Info
  272.               Log File            This is the path and name of the 
  273.                                   file that you wish MsgTrack to use 
  274.                                   for its log.  If this is not 
  275.                                   specified then there will be NO log.
  276.  
  277.               Log Data            This sub-menu allows you to select 
  278.                                   what actions you wish to have 
  279.                                   placed in the log file.  Here is a 
  280.                                   brief run-down of the action types:
  281.  
  282.                                   Fatal Errors are errors causing 
  283.                                   abortion of MsgTrack.
  284.  
  285.                                   Other Errors are non-fatal errors.
  286.  
  287.                                   Major Actions are items such as 
  288.                                   "Bounce Return Message sent to 
  289.                                   xxx/xxx", "NetMail #6 relocated to 
  290.                                   BadMail #4", "NetMail #5 Deleted".
  291.  
  292.           Log Info
  293.               Log Data            Routine Actions are items such as    
  294.                                   "Tracking, 1:243/1 -> 2:257/102".
  295.  
  296.                                   Message Info lines provide 
  297.                                   additional information about 
  298.                                   messages affected by Routine    
  299.                                   Actions.  They contain the To Name, 
  300.                                   From Name and Subject line of the    
  301.                                   message being processed.
  302.  
  303.                                   Runtime Status lines list the number 
  304.                                   of messages that MsgTrack scans in 
  305.                                   the area and the amount of RAM 
  306.                                   available for internal buffering.
  307.  
  308.                                   Trivial Messages are items such as
  309.                                   'Renumbering'. 
  310.  
  311.                                   Extended Debug logging is only 
  312.                                   useful to the author.  Turning this 
  313.                                   selection on will not have any 
  314.                                   effect unless authorized by the 
  315.                                   author.
  316.  
  317.               Log Format          This sub-menu allows you to select 
  318.                                   which of the four available log 
  319.                                   format types you wish to have used.
  320.  
  321.      2.3.3  Handling
  322.  
  323.           Attribute Bits
  324.               Strip Priority      This causes MsgTrack to remove the
  325.                                   Crash, Hold and XX2 bits and the DIR,
  326.                                   IMM and XMA flags from all passthrough
  327.                                   messages.  You can make exceptions
  328.                                   to this, see section 2.4.3. 
  329.  
  330.               Strip Attach        This causes MsgTrack to remove the
  331.                                   Attach bit from all passthrough
  332.                                   messages.  You can make exceptions
  333.                                   to this, see section 2.4.3.
  334.  
  335.               Strip Transit       This causes MsgTrack to remove the 
  336.                                   In-Transit bit from all passthrough 
  337.                                   messages.  You can make exceptions 
  338.                                   to this, see section 2.4.3.
  339.  
  340.               Strip Kill          This causes MsgTrack to remove the 
  341.                                   Kill/Sent bit from all passthrough 
  342.                                   messages.  You can make exceptions 
  343.                                   to this, see section 2.4.3.
  344.  
  345.           Attribute Bits
  346.               Add Private         This causes MsgTrack to add the 
  347.                                   Private bit to all passthrough 
  348.                                   messages.
  349.  
  350.               Strip Freq          This causes MsgTrack to remove the
  351.                                   FileRequest and UpdateRequest bits
  352.                                   from all passthrough messages.
  353.  
  354.           Miscellaneous
  355.               Map DB Flags        This causes MsgTrack to translate
  356.                                   the redundant flags used by D'Bridge
  357.                                   (PVT, CRA, RCV, SNT, FIL, K/S, HLD
  358.                                   and FRQ) to the 'standard' attribute
  359.                                   bits denoting the same status.
  360.  
  361.                                   Each flag will be striped when trans-
  362.                                   lated to an attribute bit.
  363.  
  364.               Stop Wild Att       This causes MsgTrack to remove the 
  365.                                   Attach bit from passthrough msgs, if 
  366.                                   (and only if) the attached filespec 
  367.                                   includes wildcard characters.
  368.  
  369.               Clear Cost          This causes MsgTrack to reset the 
  370.                                   Cost field in the msg header to zero 
  371.                                   (0) on all passthrough messages.
  372.  
  373.               Strip FAX           This causes MsgTrack to remove the
  374.                                   FAX related flags used by D'Bridge
  375.                                   (HIR, COV, SIG, LET) from all pass-
  376.                                   through messages.
  377.  
  378.      2.3.4  Actions
  379.  
  380.           NodeList Lookup
  381.               Check NodeList      This tells MsgTrack to check through 
  382.                                   the nodelist index for the Origin 
  383.                                   and Destination Address on each msg.  
  384.                                   If the address is not found, the 
  385.                                   message will not be forwarded.
  386.  
  387.                                   If this is not turned on, none of 
  388.                                   the other NodeList Lookup functions 
  389.                                   will be operative.
  390.  
  391.               Only My Zone        This tells MsgTrack to only confirm 
  392.                                   the existence of the Zone, not the 
  393.                                   Net and Node, for addresses outside 
  394.                                   of your primary Zone.
  395.  
  396.           NodeList Lookup
  397.               Skip Node Level     This tells MsgTrack not to check the 
  398.                                   Node address, only the Zone and Net, 
  399.                                   for addresses outside of your net.
  400.  
  401.               Return Bad Dest     This tells MsgTrack to Return 
  402.                                   messages with unknown destination 
  403.                                   addresses to the sender.
  404.  
  405.                                   The text for the return message may
  406.                                   be specified in BAD_DEST.MTB (in the
  407.                                   AFI environment directory).  If this
  408.                                   file is not present, default text
  409.                                   will be used.
  410.  
  411.               Warn Bad Orig       This tells MsgTrack to warn the 
  412.                                   recipient if the origin address on 
  413.                                   the message is unlisted.
  414.  
  415.               Hold Bad Orig       This tells MsgTrack to move any 
  416.                                   message with an unknown origin 
  417.                                   address to BadMail (or, delete it if 
  418.                                   the following option is used).
  419.  
  420.               Kill Failed Msgs    This tells MsgTrack to delete 
  421.                                   messages that failed the Nodelist 
  422.                                   lookup, instead of moving them to 
  423.                                   the BadMail area.
  424.  
  425.           EchoMail Handler  
  426.               Bounce EchoMail     This tells MsgTrack to disallow 
  427.                                   routed EchoMail. You can make 
  428.                                   exceptions to this, see section 
  429.                                   2.4.3.
  430.  
  431.                                   If this is not turned on, none of 
  432.                                   the other EchoMail Handler functions 
  433.                                   will be operative.
  434.  
  435.               Return to Sender    This tells MsgTrack to Return routed 
  436.                                   EchoMail messages to the sender.
  437.  
  438.                                   The text for the return message may
  439.                                   be specified in ECHOMAIL.MTB (in the
  440.                                   AFI environment directory).  If this
  441.                                   file is not present, default text
  442.                                   will be used.
  443.  
  444.               Kill Failed Msgs    This tells MsgTrack to delete routed 
  445.                                   EchoMail messages, instead of moving 
  446.                                   them to the BadMail area.
  447.  
  448.           Bad UUCP Handler  
  449.               Bounce Bad UUCP     This tells MsgTrack to bounce 
  450.                                   messages that are addressed to UUCP
  451.                                   on your system, but do not contain
  452.                                   a valid TO: routing line or are
  453.                                   marked as 'Orphan'.
  454.  
  455.                                   This option is only useful to those
  456.                                   running a FidoNet<->UUCP gateway.
  457.  
  458.                                   If this is not turned on, none of 
  459.                                   the other Bad UUCP Handler functions 
  460.                                   will be operative.
  461.  
  462.               Return to Sender    This tells MsgTrack to Return bad 
  463.                                   UUCP messages to the sender.
  464.  
  465.                                   The text for the return message may
  466.                                   be specified in BAD_UUCP.MTB (in the
  467.                                   AFI environment directory).  If this
  468.                                   file is not present, default text
  469.                                   will be used.
  470.  
  471.               Kill Failed Msgs    This tells MsgTrack to delete bad 
  472.                                   UUCP messages, instead of moving
  473.                                   them to the BadMail area.
  474.  
  475.  
  476.           Send Copies             You may enter a list of upto 5 
  477.                                   addresses where you wish messages 
  478.                                   addressed to you to be copied.  
  479.  
  480.                                   MsgTrack treats a message as  being 
  481.                                   addressed to you if it is addressed 
  482.                                   to one of the names listed under 
  483.                                   Sysops (see section 2.3.2) at one of 
  484.                                   your addresses (see section 2.3.2).
  485.  
  486.                                   You may additionally specify whether 
  487.                                   or not the original message should 
  488.                                   be deleted after it has been 
  489.                                   processed by Send Copies.  
  490.  
  491.      2.3.5  Miscellaneous
  492.  
  493.           Action Settings
  494.               Bounce Local Msgs   This tells MsgTrack to apply all
  495.                                   configured 'bounce' tests against
  496.                                   locally entered messages (mail
  497.                                   to/from your system), as well as
  498.                                   to passthrough mail.
  499.  
  500.           Action Settings
  501.               Ignore Zones        This tells MsgTrack to ignore Zone 
  502.                                   numbers during all address lookups.
  503.  
  504.               Move Sent Msgs      This tells MsgTrack to move msgs 
  505.                                   marked 'Sent' to the SentMsgs area.
  506.  
  507.               Move Rcvd Msgs      This tells MsgTrack to move msgs 
  508.                                   marked 'Rcvd' to the RcvdMsgs area.
  509.  
  510.               Gate INTL Mail      This tells MsgTrack to Zonegate 
  511.                                   route any Inter-Zone messages that 
  512.                                   are not already Zonegated.
  513.  
  514.               UnGate INTL Mail    This tells MsgTrack to remove Zone- 
  515.                                   gate routing on Inter-Zone messages.
  516.  
  517.               Keep Bounce Msgs    This tells MsgTrack not to mark any 
  518.                                   of the return messages, associated 
  519.                                   with bouncing mail, as Kill/Sent.
  520.  
  521.               FrontDoor Rescan    This tells MsgTrack to force 
  522.                                   FrontDoor (mailer/editor) to rescan 
  523.                                   the NetMail area if any changes have 
  524.                                   been made to the contents.
  525.  
  526.               Renumber NetMail    This tells MsgTrack to renumber the 
  527.                                   NetMail area.
  528.  
  529.                                   You can also cause multiple areas
  530.                                   to be renumbered by using the
  531.                                   -R<file> command line option.
  532.  
  533.               Full Screen Mode    This tells MsgTrack to operate in 
  534.                                   Full Screen mode, instead of BIOS
  535.                                   scroll mode.
  536.  
  537.               Force INTL Line     This tells MsgTrack to place an
  538.                                   INTL line into =all= messages.
  539.  
  540.               Process Packets     This tells MsgTrack to unpack any mail
  541.                                   packets (*.PKT files) that are in your
  542.                                   Inbound area.  USE THIS WITH CARE!
  543.  
  544.               Kill Inbound Freq   This tells MsgTrack to delete any
  545.                                   message that is addressed to your
  546.                                   system and has the File Request or
  547.                                   Update Request attribute bit set.
  548.  
  549.           Colour Choices
  550.               Customized          This allows you to manually select 
  551.                                   what colours MsgTrack will use while 
  552.                                   operating in Full Screen Mode.
  553.  
  554.           Colour Choices
  555.               Default mono set    This tells MsgTrack to use its 
  556.                                   default monochrone colour set while 
  557.                                   operating in Full Screen Mode.
  558.  
  559.               Default colour set  This tells MsgTrack to use its 
  560.                                   default CGA/EGA/VGA colour set while 
  561.                                   operating in Full Screen Mode.
  562.  
  563.  
  564.      2.4  Managers
  565.  
  566.           The managers allow you to control MsgTrack's powerful Point, 
  567.           Node, Exceptions and Routing handling functions.  All four
  568.           managers will now be explained.
  569.  
  570.  
  571.      2.4.1  Point Manager
  572.  
  573.           The Point Manager is a complete Point management interface.  
  574.           It allows you to specify upto 500 points and fully control 
  575.           what actions will be taken on each.
  576.  
  577.           Note that nothing you do in the Point Manager will become 
  578.           permanent until you exit and save your changes.
  579.  
  580.  
  581.      2.4.1.1  Wildcard macros
  582.  
  583.           When entering a name, you may specify an asterix (*) at the
  584.           end of the name.  This will cause a strict match only to be
  585.           made upto that point in the string, escentially wildcarding
  586.           the tail end of the string.
  587.  
  588.           Example:  Using "Andre*" would cause a match with "andrew
  589.                     farmer", "Andre Gagnon" or "Andrea Johnson".
  590.  
  591.  
  592.      2.4.1.2  Keystroke actions
  593.  
  594.           Enter                   Edit an existing entry.
  595.  
  596.           F1                      Toggle the active status of the 
  597.                                   current entry.  If the active status 
  598.                                   is set to no, then the entry will be 
  599.                                   ignored.
  600.  
  601.           F2                      Toggle the Mapping method.  This can 
  602.                                   be set to either Point or PvtNet.  
  603.                                   If set to Point, mail for that point 
  604.                                   will be addressed using a fully 
  605.                                   qualified 4-dimensional address.  If 
  606.                                   set to PvtNet, mail for that point 
  607.                                   will be addressed using a 3-
  608.                                   dimensional private network address.
  609.  
  610.           F3                      Global settings:
  611.  
  612.                                   If 'Map from Pvt Net' is set to yes, 
  613.                                   then any mail that originates in 
  614.                                   your private network will be 
  615.                                   remapped to show a fully qualified 
  616.                                   4-dimensional origin address.
  617.  
  618.                                   If 'Files to Points' is set to yes, 
  619.                                   then mail addressed to your points, 
  620.                                   that also has the Attach bit set, 
  621.                                   will have your Inbound path inserted 
  622.                                   as the 'attach path' for the file.
  623.  
  624.           Ins                     Insert a new entry.
  625.  
  626.           Del                     Delete an existing entry.
  627.  
  628.           Esc                     Exit/Save.
  629.  
  630.  
  631.      2.4.2  Node Manager
  632.  
  633.           The Node Manager is a complete Node management interface.  
  634.           It allows you to specify upto 500 addresses, or user names, 
  635.           whose mail you wish to have readdressed to a different 
  636.           destination.
  637.  
  638.           Note that nothing you do in the Node Manager will become 
  639.           permanent until you exit and save your changes.
  640.  
  641.  
  642.      2.4.2.1  Wildcard macros
  643.  
  644.           When entering a name, you may specify an asterix (*) at the
  645.           end of the name.  This will cause a strict match only to be
  646.           made upto that point in the string, escentially wildcarding
  647.           the tail end of the string.
  648.  
  649.           Example:  Using "Andre*" would cause a match with "andrew
  650.                     farmer", "Andre Gagnon" or "Andrea Johnson".
  651.  
  652.      2.4.2.2  Select menu
  653.      
  654.           A note about the 'Select' menu that will pop up whenever you 
  655.           hit Enter or Ins.
  656.  
  657.           If you select 'UserName' then you will be asked to enter a 
  658.           username followed by the node where that user's mail should 
  659.           be sent.  Note that only mail addressed to the specified 
  660.           user AT ONE OF YOUR ADDRESSES will be processed in this 
  661.           case.
  662.  
  663.           If you select 'Address' then you will be asked to enter a 
  664.           network address followed by the node where the mail should 
  665.           be readdressed.
  666.  
  667.           The default display screen will show an at sign (@) in front 
  668.           of all entries where you have selected 'Address'.
  669.  
  670.  
  671.      2.4.2.3  Keystroke actions
  672.  
  673.           Enter                   Edit an existing entry.
  674.  
  675.           F1                      Toggle the active status of the 
  676.                                   current entry.  If the active status 
  677.                                   is set to no, then the entry will be 
  678.                                   ignored.
  679.  
  680.           Ins                     Insert a new entry.
  681.  
  682.           Del                     Delete an existing entry.
  683.  
  684.           Esc                     Exit/Save.
  685.  
  686.  
  687.      2.4.3  Exceptions Manager
  688.  
  689.           The Exceptions Manager is a complete Exceptions management 
  690.           interface.  It allows you to specify upto 500 addresses 
  691.           (wildcards are allowed, read on) that should be excepted 
  692.           from 'Strip Priority', 'Strip Attach', 'Strip Kill/Transit',
  693.           and/or 'Bounce EchoMail' actions.
  694.  
  695.           Note that nothing you do in the Exceptions Manager will 
  696.           become permanent until you exit and save your changes.
  697.  
  698.      2.4.3.1  Wildcard macros
  699.  
  700.           When entering an address, you may specify an asterix (*) in 
  701.           any, or all, address portions (the 4 valid address portions 
  702.           are:  Zone, Net, Node and Point).
  703.  
  704.           Note that wildcarding will auto-flow in a greater to lesser 
  705.           direction.  That means that if you specify an asterix in the 
  706.           Net position, Node and Point will also be wildcarded.
  707.  
  708.           For example:
  709.  
  710.               Entering 1:243/* will cause any node in Zone 1, Network 
  711.               243, plus all point under them, to be excepted from the 
  712.               specified actions.  This would be displayed on the 
  713.               default screen as 1:243/All.All.
  714.  
  715.               Entering 3:*/* will cause any node/point in Zone 3 to be 
  716.               excepted from the specified actions.  This would be 
  717.               displayed on the default screen as 3:All/All.All.
  718.  
  719.               Entering 1:243/1.* will cause all points of 1:243/1 to
  720.               be excepted from the specified actions.  This would be
  721.               displayed on the default screen as 1:243/1.All.
  722.  
  723.  
  724.      2.4.3.2  Keystroke actions 
  725.  
  726.           Enter                   Edit an existing entry.
  727.  
  728.           F1                      Toggle the active status of the 
  729.                                   current entry.  If the active status 
  730.                                   is set to no, then the entry will be 
  731.                                   ignored.
  732.  
  733.           F2                      Select Origination exceptions. These 
  734.                                   are the actions that the specified 
  735.                                   address(es) should be excepted from 
  736.                                   if the message is FROM them.
  737.  
  738.           F3                      Select Destination exceptions. These 
  739.                                   are the actions that the specified 
  740.                                   address(es) should be excepted from 
  741.                                   if the message is FROM them.
  742.  
  743.           Ins                     Insert a new entry.
  744.  
  745.           Del                     Delete an existing entry.
  746.  
  747.           Esc                     Exit/Save.
  748.  
  749.  
  750.      2.4.4  Routing Manager
  751.  
  752.           The Routing Manager is a complete Routing management
  753.           interface.  It allows you to specify upto 500 addresses
  754.           (with user names if you wish), whose mail you will not
  755.           route.
  756.  
  757.           You may further select to disallow mail FROM this
  758.           address/name, mail TO this address/name or go hog wild and
  759.           disallow mail that is either FROM or TO this address/name.
  760.  
  761.           Note that nothing you do in the Routing Manager will become 
  762.           permanent until you exit and save your changes.
  763.  
  764.  
  765.      2.4.4.1  Wildcard macros
  766.  
  767.           When entering an address, you may specify an asterix (*) in 
  768.           any, or all, address portions (the 4 valid address portions 
  769.           are:  Zone, Net, Node and Point).
  770.  
  771.           Note that wildcarding will auto-flow in a greater to lesser 
  772.           direction.  That means that if you specify an asterix in the 
  773.           Net position, Node and Point will also be wildcarded.
  774.  
  775.           For example:
  776.  
  777.               Entering 1:243/* will cause any node in Zone 1, Network 
  778.               243, plus all point under them, to be excepted from the 
  779.               specified actions.  This would be displayed on the 
  780.               default screen as 1:243/All.All.
  781.  
  782.               Entering 3:*/* will cause any node/point in Zone 3 to be 
  783.               excepted from the specified actions.  This would be 
  784.               displayed on the default screen as 3:All/All.All.
  785.  
  786.               Entering 1:243/1.* will cause all points of 1:243/1 to
  787.               be excepted from the specified actions.  This would be
  788.               displayed on the default screen as 1:243/1.All.
  789.  
  790.      2.4.4.2  Keystroke actions
  791.  
  792.           Enter                   Edit an existing entry.
  793.  
  794.           F1                      Toggle the active status of the 
  795.                                   current entry.  If the active status 
  796.                                   is set to no, then the entry will be 
  797.                                   ignored.
  798.  
  799.           F2                      Select your DisAllow value.  It may
  800.                                   be set to NONE, TO, FROM or BOTH.
  801.  
  802.           F3                      Global settings:
  803.  
  804.                                   If 'Return to Sender' is set to yes, 
  805.                                   then any mail that is bounced on a
  806.                                   routing violation will be returned
  807.                                   to the sender.
  808.  
  809.                                   If 'Kill Failed Msgs' is set to yes, 
  810.                                   then any mail that is bounced on a
  811.                                   routing violation will be deleted,
  812.                                   instead of being relocated to the
  813.                                   BadMail area.
  814.  
  815.           Ins                     Insert a new entry.
  816.  
  817.           Del                     Delete an existing entry.
  818.  
  819.           Esc                     Exit/Save.
  820.  
  821.  
  822.                                    Chapter 3
  823.  
  824.                                     MsgTrack
  825.  
  826.  
  827.           The main program, MT.EXE, is ready to run once you have
  828.           configured with MTSetup and placed SYSTEM.MT (plus MT.KEY,
  829.           POINTSYS.MT, NODESYS.MT, EXCEPSYS.MT and ROUTESYS.MT if
  830.           applicable) into one of the directories where MsgTrack will
  831.           look for them (see section 1.3).
  832.  
  833.  
  834.      3.1  Video mode
  835.  
  836.           When operating in Full Screen mode, MsgTrack uses direct 
  837.           screen writes.  When operating in Scroll mode, MsgTrack 
  838.           writes to the screen using calls to the undocumented BIOS 
  839.           interrupt 29.  In both cases output in =not= redirectable.
  840.  
  841.           Note:  If MsgTrack detects DESQview, any direct screen
  842.                  writes will be done via the DV shadow buffer.
  843.  
  844.  
  845.      3.2  Command line syntax
  846.  
  847.           MsgTrack can be executed without any command line options, 
  848.           but a number of specialized features are available from the 
  849.           command  line.  Command line switches may be  preceded  with 
  850.           either a dash (-) or the currently configured DOS switch
  851.           char (normally a forward slash).
  852.  
  853.           Syntax/Usage:  MT <optional switches>
  854.  
  855.               -?                  This will cause MsgTrack to display 
  856.                                   a Syntax/Usage screen, then abort 
  857.                                   with nothing Done.
  858.  
  859.               -A                  By default, MsgTrack will NEVER
  860.                                   process message from ARCmail or
  861.                                   Tick on your system.  This switch
  862.                                   will override that default.
  863.  
  864.               -D                  When used with -P, this will cause 
  865.                                   the file(s) to be deleted after 
  866.                                   being posted.
  867.  
  868.               -F                  This will force MsgTrack to compile 
  869.                                   its NodeList Index, even if no 
  870.                                   compile is necessary, then abort 
  871.                                   with nothing else done.
  872.  
  873.               -L                  This will cause MsgTrack to NEVER
  874.                                   bounce locally entered messages.
  875.  
  876.               -Mdir               This will cause MsgTrack to scan the 
  877.                                   path specified by 'dir', instead of 
  878.                                   the NetMail area specified in your 
  879.                                   configuration.
  880.  
  881.               -N                  By default, MsgTrack will will 
  882.                                   automatically re-compile its 
  883.                                   NodeList index if it judges that a 
  884.                                   compile is necessary. Using this 
  885.                                   switch will 'short circuit' the 
  886.                                   auto-compile logic, telling MsgTrack 
  887.                                   to use the existing Index file, even 
  888.                                   if it is out-of-date.
  889.  
  890.               -Pfile              This will cause MsgTrack to post the 
  891.                                   file(s) specified by 'file' as msgs 
  892.                                   in your NetMail area. 'file' can 
  893.                                   include wildcards characters.
  894.  
  895.               -Q                  This will cause MsgTrack to run in 
  896.                                   Quiet mode, providing only minimal 
  897.                                   screen output.
  898.  
  899.               -R<file>            This will cause MsgTrack to renumber 
  900.                                   the NetMail area, then exit with 
  901.                                   nothing else done.
  902.  
  903.                                   The optional <file> is a raw ASCII 
  904.                                   text file listing one directory path 
  905.                                   per line.  If this is specified, 
  906.                                   then MsgTrack will renumber all 
  907.                                   directories listed therein.
  908.  
  909.               -S                  This causes MsgTrack NOT to include
  910.                                   the Subject line in 'Message Info'
  911.                                   log enties.
  912.  
  913.               -Tlogfile           This tells MsgTrack to use the 
  914.                                   path/filename specified by 'logfile' 
  915.                                   for its log, instead of the log file 
  916.                                   specified in your configuration.
  917.  
  918.  
  919.      3.3  Errorlevels
  920.  
  921.           The  following is a run-down of the 4 possible ErrorLevels 
  922.           that MsgTrack can exit with:
  923.  
  924.           Errorlevel 3            MsgTrack processed some messages.
  925.  
  926.           Errorlevel 2            Fatal Error - program abortion.
  927.  
  928.           Errorlevel 1            Fatal Error - program abortion.
  929.  
  930.           Errorlevel 0            Successful completion.
  931.  
  932.  
  933.                                    Chapter 4
  934.  
  935.                                   Log Analyzer
  936.  
  937.  
  938.           The log analyzer, MTLOG.EXE, is a small utility program
  939.           that will take as input a MsgTrack log (wildcards are
  940.           valid, so you can process multiple logs in one pass) and
  941.           output a report file.
  942.  
  943.  
  944.      4.1  Report
  945.  
  946.           The report file consists of 3 sections.
  947.  
  948.           The Activity report lists the total number of times a
  949.           particular action was executed.
  950.  
  951.           The From report lists msgs/bytes that were FROM a specific
  952.           address, no matter what the destination address was.
  953.  
  954.           The To report lists msgs/bytes that were TO a specific
  955.           address, no matter what the origination address was.
  956.  
  957.  
  958.      4.2  Video mode
  959.  
  960.           MTLog uses Standard Output for screen writes.
  961.  
  962.  
  963.      4.3  Command line syntax
  964.  
  965.           MTLog must be executed with two (2) command line options.
  966.  
  967.           Syntax/Usage:  MTLog [LogFile] [Report]
  968.  
  969.               LogFile             This is the MT logs(s) you wish to
  970.                                   process.  Wildcards are valid.
  971.  
  972.               Report              This is the path/filespec MTLog
  973.                                   should write its report file to.
  974.                                   Note that MTLog will OVERWRITE any
  975.                                   existing file by this name.
  976.  
  977.      4.4  Errorlevels
  978.  
  979.           The following are the 2 possible ErrorLevels that MTLog can
  980.           exit with:
  981.  
  982.           Errorlevel 1            Fatal Error - program abortion.
  983.  
  984.           Errorlevel 0            Successful completion.
  985.  
  986.  
  987.                                    Appendix A
  988.  
  989.  
  990.                           Program support - Help nodes
  991.  
  992.  
  993.           If you have any questions, concerns or reports of unexpected 
  994.           behavior in the software, the author can be contacted in the 
  995.           following ways:
  996.  
  997.  
  998.           Electronic:
  999.  
  1000.               FidoNet:     1:243/1
  1001.  
  1002.               Internet:    adf@aficom.ocunix.on.ca
  1003.  
  1004.  
  1005.           Surface:
  1006.  
  1007.               Andrew D. Farmer
  1008.               P.O.Box 11087, Station H
  1009.               Nepean, Ontario
  1010.               K2H 7T8  CANADA
  1011.  
  1012.  
  1013.           Inquiries and questions about installation or operation may 
  1014.           also be addressed to the following help nodes: 
  1015.  
  1016.  
  1017.           Europe:                 Noel Bradford
  1018.                                   Broxbourne, United Kingdom
  1019.                                   2:257/102@fidonet
  1020.  
  1021.                                   Peter Janssens
  1022.                                   Venray, Netherlands
  1023.                                   2:512/1@fidonet
  1024.  
  1025.           North America:          Bruce Bodger
  1026.                                   Tulsa, Oklahoma
  1027.                                   1:170/400@fidonet
  1028.  
  1029.  
  1030.  
  1031.                                   Appendix B
  1032.  
  1033.                           Thanks for all the fish...
  1034.  
  1035.  
  1036.           I would like to take this opportunity to thank all of the 
  1037.           people that helped to make MsgTrack what it is.  Over the
  1038.           years they have tested the pants off it, contributed many
  1039.           excellent feature ideas and inspired me to new heights, but
  1040.           above all they are a great bunch of people.  Let's give them
  1041.           all a standing ovation.  In alphabetical order, they are:
  1042.  
  1043.           John Barton, Bruce Bodger, Noel Bradford, Orlando Castillo,
  1044.           Greg Dawson, David Dodell, Scott Dudley, Tom Hall, Tom
  1045.           Hendricks, Jesse David Hollington, Joaquim Homrighausen,
  1046.           Mark Howard, Dave Hunter, Eric Jacksch, Peter Janssens,
  1047.           Felix Kasza, Bill Kraski, Renald Loignon, Joop Mellaart,
  1048.           Bruce Miller, jim nutt, David Osborne, George Peace,
  1049.           James Smith, Dieter Soltau, John Souvestre, Dan Thomson,
  1050.           Ken Wilson and several others that I have no doubt forgotten
  1051.           to mention (my appologies).
  1052.  
  1053.  
  1054.                                 Closing comments
  1055.  
  1056.           I have tried to make this documentation as complete as 
  1057.           possible, but there are always some small things that slip 
  1058.           through the cracks and aren't documented, or aren't 
  1059.           documented correctly.  I apologize in advance for any such 
  1060.           errors that may occur.
  1061.    
  1062.           I hope that you enjoy using MsgTrack and that it provides 
  1063.           you with the features you need to keep your netmail flow
  1064.           under control in our increasingly complex environment.
  1065.  
  1066.           MsgTrack is still very much 'in development' and I am always 
  1067.           open to feature suggestions, so please feel free to let me 
  1068.           know if you have some ideas that would make MsgTrack even 
  1069.           better.
  1070.  
  1071.           Andrew D. Farmer
  1072.           Ottawa, Ontario, Canada
  1073.           Friday, January 1, 1993
  1074.